// 《围棋》作者版权所有。保留所有权利。
// 此源代码的使用受BSD样式
// 许可证的约束，该许可证可以在许可证文件中找到。

// 包str提供字符串操作实用程序。
package str

import (
	"bytes"
	"fmt"
	"unicode"
	"unicode/utf8"
)

// StringList将其参数展平为单个[]字符串。
// args中的每个参数都必须具有类型string或[]string。
func StringList(args ...any) []string {
	var x []string
	for _, arg := range args {
		switch arg := arg.(type) {
		case []string:
			x = append(x, arg...)
		case string:
			x = append(x, arg)
		default:
			panic("stringList: invalid argument of type " + fmt.Sprintf("%T", arg))
		}
	}
	return x
}

// ToFold返回一个字符串，其属性为
// strings。EqualFold（s，t）iff ToFold（s）=ToFold（t）
// 这让我们可以测试一大组字符串的折叠等效
// 重复，而无需对EqualFold进行二次调用
// 。注意字符串。图珀和弦。ToLower 
// 在某些情况下没有所需的属性。
func ToFold(s string) string {
	// 快速路径：全部为ASCII，无大写。
	// 大多数路径已经是这样了。
	for i := 0; i < len(s); i++ {
		c := s[i]
		if c >= utf8.RuneSelf || 'A' <= c && c <= 'Z' {
			goto Slow
		}
	}
	return s

Slow:
	var buf bytes.Buffer
	for _, r := range s {
		// 将（x）个循环简化为下一个等效符文>x 
		// 或将其压缩为更小的值。迭代直到它结束，我们找到了最小值。
		for {
			r0 := r
			r = unicode.SimpleFold(r0)
			if r <= r0 {
				break
			}
		}
		// 允许上面的快速路径的异常：A-Z=>A-Z 
		if 'A' <= r && r <= 'Z' {
			r += 'a' - 'A'
		}
		buf.WriteRune(r)
	}
	return buf.String()
}

// FoldDup报告列表中根据字符串相等的一对字符串。埃科福尔德。
// 如果没有这样的字符串，则返回“”。
func FoldDup(list []string) (string, string) {
	clash := map[string]string{}
	for _, s := range list {
		fold := ToFold(s)
		if t := clash[fold]; t != "" {
			if s > t {
				s, t = t, s
			}
			return s, t
		}
		clash[fold] = s
	}
	return "", ""
}

// 包含x是否包含s的报告。
func Contains(x []string, s string) bool {
	for _, t := range x {
		if t == s {
			return true
		}
	}
	return false
}

// Uniq从ss中删除连续的重复字符串。
func Uniq(ss *[]string) {
	if len(*ss) <= 1 {
		return
	}
	uniq := (*ss)[:1]
	for _, s := range *ss {
		if s != uniq[len(uniq)-1] {
			uniq = append(uniq, s)
		}
	}
	*ss = uniq
}
